home *** CD-ROM | disk | FTP | other *** search
/ Aminet 5 / Aminet 5 - March 1995.iso / Aminet / dev / c / cweb33p11a.readme < prev    next >
Text File  |  1995-02-12  |  13KB  |  210 lines
  1. Short:    Literate programming discipline for C/C++.
  2. Author:   levy@geom.umn.edu (Silvio Levy and Donald E. Knuth)
  3. Uploader: scherer@genesis.informatik.rwth-aachen.de (Andreas Scherer)
  4. Type:     dev/c
  5. Files:    cweb33p11a.lha, cweb33p11a.readme
  6.  
  7. This  is  the  portability implementation of Silvio Levy's and Donald Ervin
  8. Knuth's CWEB system, version 3.3 of December 7, 1994, compiled and provided
  9. with  changefiles  for  ANSI-C,  TURBO-C,  and  SAS/C 6.x and makefiles for
  10. UNIX-make,  Borland-make  and  SAS-make by Andreas Scherer.  It is based on
  11. the  CWEB 3.1 port by Tomas Charles Willis and the CWEB 2.8 port by Carsten
  12. Steger  and  the  CWEB-p  3.0  distribution  by Hans-Hermann Bode and Klaus
  13. Guntermann, including all features of the original UNIX implementation like
  14. ANSI-C  and  C++  support,  full ASCII input capability, and more, plus all
  15. enhancements  made  in these AMIGA, MSDOS, and UNIX ports plus some special
  16. features like:
  17.  
  18.    - The complete source code is capable of being recompiled with SAS/C for
  19.      AmigaOS, with Borland C/C++ 3.1 for MSDOS, and with  CC, C89, and  GCC
  20.      for  UNIX without the need for further changes.  The Amiga versions of
  21.      all three system programs are compiled and linked in genuine C++ mode.
  22.      For compilation in  ANSI-C mode rename the .cc files to their .c form,
  23.      and modify the EXTENSION field in the makefile accordingly.
  24.  
  25.    - The `+l' option with its  argument `X' causes CWEAVE to prepend `X' to
  26.      `cwebmac.tex' in  the first line of the output file.  `X'  may  be any
  27.      string of characters (case dependent and possibly empty), e.g., if you
  28.      called  CWEAVE  with  the  option  `+ldansk',  the  danish  macro file
  29.      `danskcwebmac.tex'  would  be  included instead of `cwebmac.tex'.  The
  30.      macro  file  `Xcwebmac.tex' itself contains some  modifications to the
  31.      original `cwebmac.tex' file as described in the documentation.   There
  32.      are macro packages `dcwebmac.tex' by Andreas Scherer for German users,
  33.      `icwebmac.tex'  by  Giuseppe Ghibò  for Italian users, and lately even
  34.      `fcwebmac.tex' by  Denis B. Roegel for French CWEB programmers.  These
  35.      macro  files  translate all captions used by the CWEAVE processor into
  36.      the   respective  languages  and  also  include  support  for  special
  37.      characters  like umlauts  (diacritics)  and some other frequently used
  38.      specials according to ISO Latin-1, IBM  PC International Codepage 850,
  39.      Macintosh 8-bit font table and HP Roman 8.  Similar packages for other
  40.      languages  can  easily  be added to this scheme.  To date there are no
  41.      conflicting languages, so single-character strings are used.
  42.  
  43.    - There  are  TeX macro  files `ecma94.sty', `hp8.sty', `mac8.sty',  and
  44.      `pc850.sty' for  support  of  extended  code  tables.  These have been
  45.      set up to work as `packages' for LaTeX2e too.  Also  included  are the
  46.      files `ecma94.w', `hp8.w',  `mac8.w',  and  `pc850.w' with appropriate
  47.      transliteration  tables.   The option  `+a'  of former versions of the
  48.      AMIGA installation is now replaced by the file  `amiga_types.w', which
  49.      can be `@i'ncluded in the source files where needed.
  50.  
  51.    - Two  AREXX  scripts for use with the CygnusEd Professional Editor were
  52.      added to this package, one for CTANGLE and CWEAVE, localized  with the
  53.      help of language catalogs under  AmigaOS version 2.1 or 3.0, the other
  54.      for use with the SAS/C 6.x compiler in connection with CED V3.5.
  55.  
  56.    - Both CTANGLE and CWEAVE are fully localized with  the help of language
  57.      catalogs and the `locale.library' of  AmigaOS 2.1/3.0.  Default is (of
  58.      course)  English;  catalogs  for  German  and Italian are provided and
  59.      other language catalogs  can easily be added.  #include files with the
  60.      English,  German,  and  Italian strings are provided for non-localized
  61.      operating systems.
  62.  
  63.    - An algorithm for recursive `@i'nclude file search was adapted from the
  64.      TeX  and  METAFONT  implementation.  The current directory is searched
  65.      first,  then the contents of the (possibly empty) environment variable
  66.      CWEBINPUTS, and then the (system dependent) internal defaults given in
  67.      the compile-time constants CWEBINPUTS in the respective makefiles.
  68.  
  69.    - The `-o' option was added in connection with `-i' by Carsten Steger.
  70.  
  71.    - Five additional CWEB example programs are included as examples for the
  72.      portability between PASCAL-WEB and C-CWEB and for the usage of the C++
  73.      features of version 3.1.  The  fifth  example program is a simple text
  74.      converter  for  files  with  extended  character codes of ISO-Latin-1,
  75.      PC-850, MAC 8-bit font, and HP 8-bit font.
  76.  
  77.    - All three system programs support the `version' information command.
  78.  
  79.    - All  three  system  programs are compiled in the NEAR data segment and
  80.      can be made resident.
  81.  
  82.    - The `+m' option enables ARexx communication between CWEB and the SAS/C
  83.      message browser SCMSG.  Any warnings or error messages are transferred
  84.      to its list  window.  The behaviour of  this feature can be controlled
  85.      via  the  external  environment variable SCMSGOPT, which may be set to
  86.      any legal option string as described in the documentation of the SAS/C
  87.      development system by SAS Institute.
  88.  
  89.    - The  output  files are only written when there are significant changes
  90.      to  their  contents, i.e., when  a CWEB source creates multiple output
  91.      files,  only  those  modules effected by changes will be recompiled in
  92.      the  `make'  process.  This mechanism was taken from  Preston Briggs's
  93.      NUWEB program, to whom credit is due.
  94.  
  95. Major  parts  of this Amiga port were done and completely tested with SAS/C
  96. version  6.3  and  SAS/C++ version 6.51 on the AMIGA.  After completion the
  97. official version [p10] of the package was re-ported to various UNIX systems
  98. (HP  9000, HP-PA, Sun, SGI) with CC, C89, and GCC, and ported to MSDOS with
  99. Borland  C/C++  3.1.  Provided that all these ports work successfully, I am
  100. quite sure that all bugs have been found and fixed.
  101.  
  102. New  and  modified  features  were tested on the AMIGA with SAS/C++ 6.51 in
  103. both  ANSI-C  and C++ mode and on a DEC station running Ultrix 4.4 with the
  104. DEC  CC compiler.  Again the resulting system was then ported to MSDOS with
  105. Borland  C/C++  3.1,  now  in  the form of three C++ projects (there wasn't
  106. enough  free  memory  to  start  Borland-make  from  within the development
  107. environment, so Makefile.pc actually wasn't tested).
  108.  
  109. As Levy and Knuth seem to have changed their update policy, this is the
  110. second version of CWEB 3.3 in December 1994.  Right after patch level 11
  111. was installed in the AmiNet, Stanford provided a new distribution.  To
  112. keep you up to date, the changes are made in this updated version too.
  113.  
  114. Enjoy, Andreas.
  115.  
  116. December 13, 1994.
  117.  
  118.  
  119. ============================= Archive contents =============================
  120.  
  121. Original  Packed Ratio    Date     Time    Name
  122. -------- ------- ----- --------- --------  -------------
  123.     2561    1288 49.7% 08-Nov-94 21:45:24  cweb/arexx/catalogs/cweb_arexx.cd
  124.     1949     978 49.8% 08-Nov-94 21:45:24  cweb/arexx/catalogs/cweb_arexx.e.ct
  125.     2600    1239 52.3% 08-Nov-94 21:45:24  cweb/arexx/catalogs/cweb_arexx.f.ct
  126.     2597    1268 51.1% 08-Nov-94 21:45:24  cweb/arexx/catalogs/cweb_arexx.i.ct
  127.      366     237 35.2% 08-Nov-94 21:45:22  cweb/arexx/catalogs/english/cweb_arexx.catalog
  128.      412     272 33.9% 08-Nov-94 21:45:22  cweb/arexx/catalogs/francais/cweb_arexx.catalog
  129.      392     254 35.2% 08-Nov-94 21:45:22  cweb/arexx/catalogs/italiano/cweb_arexx.catalog
  130.     5153    2112 59.0% 08-Nov-94 21:45:24  cweb/arexx/compile.ced
  131.    12913    4923 61.8% 03-Dec-94 09:01:44  cweb/arexx/start_web.ced
  132.     9609    2981 68.9% 03-Dec-94 09:04:22  cweb/bin/catalogs/cweb.cd
  133.    14901    4770 67.9% 03-Dec-94 09:04:12  cweb/bin/catalogs/cweb.d.ct
  134.    17541    3697 78.9% 03-Dec-94 09:04:34  cweb/bin/catalogs/cweb.h
  135.    14739    4634 68.5% 03-Dec-94 09:04:08  cweb/bin/catalogs/cweb.i.ct
  136.    18339    3904 78.7% 03-Dec-94 09:04:34  cweb/bin/catalogs/dcweb.h
  137.     6616    2343 64.5% 03-Dec-94 09:04:52  cweb/bin/catalogs/deutsch/cweb.catalog
  138.    18340    3947 78.4% 03-Dec-94 09:04:34  cweb/bin/catalogs/icweb.h
  139.     6470    2350 63.6% 03-Dec-94 09:05:02  cweb/bin/catalogs/italiano/cweb.catalog
  140.      776     408 47.4% 14-Mar-94 16:44:02  cweb/comm-man.ch
  141.     2546    1150 54.8% 19-Nov-93 10:29:10  cweb/comm-vms.ch
  142.    36838   10185 72.3% 13-Dec-94 20:56:20  cweb/common.cc
  143.    68007   18950 72.1% 13-Dec-94 20:53:54  cweb/common.ch
  144.     8841    2972 66.3% 08-Nov-93 22:10:36  cweb/common.h
  145.    52111   17461 66.4% 05-Dec-94 16:21:38  cweb/common.w
  146.      777     408 47.4% 14-Mar-94 16:44:14  cweb/ctang-man.ch
  147.     1101     527 52.1% 28-Nov-94 01:10:18  cweb/ctang-vms.ch
  148.    37984   10041 73.5% 13-Dec-94 20:54:02  cweb/ctangle.cc
  149.    46140   11670 74.7% 13-Dec-94 20:53:00  cweb/ctangle.ch
  150.    54370   18216 66.4% 27-Nov-94 20:39:04  cweb/ctangle.w
  151.      777     408 47.4% 14-Mar-94 16:44:28  cweb/cweav-man.ch
  152.     1138     563 50.5% 28-Nov-94 01:08:50  cweb/cweav-vms.ch
  153.    74718   17823 76.1% 13-Dec-94 20:52:06  cweb/cweave.ch
  154.   162215   52867 67.4% 28-Nov-94 02:19:26  cweb/cweave.w
  155.     3366    1589 52.7% 08-Nov-92 19:16:24  cweb/cweb.1
  156.     8969    3252 63.7% 03-Jan-93 15:01:10  cweb/cweb.el
  157.     4647    1957 57.8% 08-Nov-94 21:45:30  cweb/cweb.man
  158.     6539    2933 55.1% 13-Dec-94 20:36:36  cweb/cweb33p11.readme
  159.    75659   27920 63.0% 05-Dec-94 16:22:44  cweb/cwebman.tex
  160.     9890    3145 68.2% 03-Dec-94 08:59:16  cweb/cwebmana.ch
  161.    27449    8428 69.2% 08-Nov-94 21:45:24  cweb/examples/cct.w
  162.    26712    9905 62.9% 08-Nov-94 21:45:24  cweb/examples/commonwords.w
  163.     1845     800 56.6% 08-Nov-94 21:45:24  cweb/examples/extex.ch
  164.    12417    4749 61.7% 10-Jun-93 13:09:30  cweb/examples/extex.w
  165.    10289    3191 68.9% 13-Jul-92 16:15:20  cweb/examples/kspell.el
  166.     3829    1310 65.7% 08-Nov-94 21:45:24  cweb/examples/Makefile
  167.      962     424 55.9% 03-Oct-92 12:25:42  cweb/examples/Makefile.org
  168.    18469    6765 63.3% 08-Nov-94 21:45:24  cweb/examples/matrix.wpp
  169.     8027    2111 73.7% 05-Dec-94 16:20:06  cweb/examples/oemacs.el
  170.    38418   15440 59.8% 10-Jan-93 14:58:46  cweb/examples/oemacs.w
  171.    11444    4398 61.5% 09-Nov-94 07:47:50  cweb/examples/primes.ch
  172.    20841    8455 59.4% 08-Nov-94 21:45:24  cweb/examples/primes.w
  173.     4267    1959 54.0% 08-Nov-94 21:45:24  cweb/examples/README
  174.     2946    1462 50.3% 03-Oct-92 12:16:08  cweb/examples/README.org
  175.     9164    3844 58.0% 08-Nov-94 21:45:26  cweb/examples/sample.w
  176.     3485    1116 67.9% 08-Nov-94 21:45:26  cweb/examples/treeprint.ch
  177.     6830    2899 57.5% 12-Sep-93 09:55:22  cweb/examples/treeprint.w
  178.     4765    1669 64.9% 08-Nov-94 21:45:26  cweb/examples/wc.ch
  179.     9029    3917 56.6% 22-Aug-94 11:30:20  cweb/examples/wc.w
  180.    25150    8695 65.4% 10-Jun-93 13:04:42  cweb/examples/wmerge.w~
  181.     1269     592 53.3% 08-Nov-94 21:45:26  cweb/examples/wordtest.ch
  182.    20892    7901 62.1% 10-Jun-93 12:59:26  cweb/examples/wordtest.w
  183.     1858     590 68.2% 09-Nov-92 00:33:42  cweb/examples/xlib_types.w
  184.     5811    1391 76.0% 09-Nov-92 00:33:56  cweb/examples/xview_types.w
  185.     1431     531 62.8% 08-Nov-94 21:45:26  cweb/include/amiga_types.w
  186.     1187     655 44.8% 08-Nov-94 21:45:26  cweb/include/ecma94.w
  187.     1187     671 43.4% 08-Nov-94 21:45:26  cweb/include/hp8.w
  188.     1163     648 44.2% 08-Nov-94 21:45:26  cweb/include/mac8.w
  189.     1183     664 43.8% 08-Nov-94 21:45:26  cweb/include/pc850.w
  190.    15319    5962 61.0% 19-Sep-94 12:14:16  cweb/macros/cwebmac.tex
  191.     6152    2479 59.7% 08-Nov-94 21:45:26  cweb/macros/dcwebmac.tex
  192.     8504    2556 69.9% 08-Nov-94 21:45:26  cweb/macros/ecma94.sty
  193.     5060    1970 61.0% 08-Nov-94 21:45:26  cweb/macros/fcwebmac.tex
  194.     7907    2412 69.4% 08-Nov-94 21:45:26  cweb/macros/hp8.sty
  195.     5983    2399 59.9% 08-Nov-94 21:45:26  cweb/macros/icwebmac.tex
  196.     7818    2425 68.9% 08-Nov-94 21:45:26  cweb/macros/mac8.sty
  197.     8347    2543 69.5% 08-Nov-94 21:45:26  cweb/macros/pc850.sty
  198.     1604     673 58.0% 03-Dec-94 09:02:32  cweb/macros/Xcwebmac.tex
  199.     7966    2977 62.6% 13-Dec-94 20:40:00  cweb/Makefile.amiga
  200.     7957    2949 62.9% 03-Dec-94 08:55:52  cweb/Makefile.pc
  201.     9047    3341 63.0% 03-Dec-94 08:56:04  cweb/Makefile.unix
  202.    13755    4070 70.4% 28-Nov-94 02:11:14  cweb/prod.w
  203.    19267    7236 62.4% 13-Dec-94 21:12:32  cweb/README
  204.     3033    1381 54.4% 02-Aug-94 12:01:08  cweb/README.org
  205.    17930    5051 71.8% 13-Dec-94 20:23:10  cweb/wmerge.cc
  206.    24732    7987 67.7% 13-Dec-94 20:19:26  cweb/wmerge.ch
  207.    25151    8698 65.4% 28-Nov-94 00:16:54  cweb/wmerge.w
  208. -------- ------- ----- --------- --------
  209.  1270758  417931 67.1% 16-Dec-94 00:15:00   85 files
  210.